<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu247.htm">Previous Page</A> &#124; <A HREF="progu249.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXNCF" HREF="progu097.htm#PToC_342">DXNewCompositeField</A></H3>
<A NAME="IDX1904"></A>
<A NAME="IDX1905"></A>
<P><STRONG>Function</STRONG>
<P>
Creates a new Composite Field Object.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
CompositeField DXNewCompositeField()<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
A Composite Field Object (a subclass of Group) is a collection of
compatible Fields, all having a "positions" component of
the same dimensionality, "data" components of the same
type, and "connections" of the same "element
type."
A Composite Field is intended to be interpreted as a collection of
Fields that together define a single Field.
<P>
Composite Fields are usually created by
<TT><STRONG>DXPartition</STRONG></TT>.
They are used to represent the spatial partitioning of one original
Field.
No member Field may overlap any other, and, where they abut they must
share exact vertex locations.
If the "connections" component of Composite Fields are regular
(i.e., Mesh Arrays), then the "connections" component of
each Field must have a "mesh offsets" attribute that
indicates where in the original grid the new Field
was located.
<P>
The type of a Composite Field
is set the first time a typed member is added;
a typed member is either a Field with a "data" component or a
typed Group.  All typed members added to a typed Composite Field
must match
the type of the Composite Field.
If a Composite Field has no members, it is untyped.
<P>
The Field created can be deleted with DXDelete.
See <A HREF="progu023.htm#HDRMEMNG">4.2 , "Memory Management"</A>.
<P><STRONG>Return Value</STRONG>
<P>
Returns the Composite Field or returns <TT><STRONG>NULL</STRONG></TT> and
sets an error code.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu208.htm#HDRDXGROV">DXGrow, DXGrowV</A>,
<A HREF="progu252.htm#HDRDXNG">DXNewGroup</A>,
<A HREF="progu255.htm#HDRDXNMG">DXNewMultiGrid</A>,
<A HREF="progu261.htm#HDRDXNS">DXNewSeries</A>,
<A HREF="progu318.htm#HDRDXSMO">DXSetMeshOffsets</A>
</STRONG></TT>
<P>
<A HREF="progu045.htm#HDRCEFD">"Composite Fields"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu247.htm">Previous Page</A> &#124; <A HREF="progu249.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
